home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d981.lha / BootUte / BootUte.doc < prev    next >
Text File  |  1994-04-04  |  12KB  |  354 lines
  1.                       Documents for BootUte v1.0
  2.               ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3.                   BootUte was written by Paul Toyne
  4.                         Released on 01/03/94.
  5.  
  6.  
  7.                    1)   What is bootute ?
  8.                    2)   BootUte's Options
  9.                    3)   Error Messages
  10.                    4)   Disclaimer
  11.                    5)   Distribution
  12.                    6)   A1200 Compatability
  13.                    7)   Greetings
  14.                    8)   Future Versions
  15.                    9)   Testing
  16.                   10)   Contacting Me
  17.  
  18.                 BootUte was written in 100% assembler.
  19.  
  20.  
  21.                           What is BootUte ?
  22.               ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  23. BootUte is a program that enables the loading, saving and executing
  24.  of bootblocks.
  25.  
  26. BootUte requires Kickstart and Workbench 2.0 or above, it also
  27.  requires any version of reqtools.library.
  28.  
  29. reqtools.library is © Nico Francois.
  30.  
  31. My main aim in producing this program was to make games and demos
  32.  that wouldn't work on my 1200 work.
  33.  
  34. I have expanded somewhat on my original idea so that it will be
  35.  useful to all people with accelerators, or with kickstart 2.0 and
  36.  above.
  37.  
  38. BootUte was written over a period of a couple of months on-off work.
  39.  
  40. It was written in 100% assembler using Devpac 3.
  41.  
  42.  
  43. Why kickstart 2.0 and above only ?
  44.  
  45. I have two reasons for that :
  46.  
  47.  1) It is a lot easier to provide a good user interface under 2.0+.
  48.  2) If you are an acclerator owner you should have at least 2.0, and
  49.      if you don't I would suggest upgrading.
  50.  
  51.  
  52.                           BootUte's options
  53.               ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  54. Bootblock operations
  55.  
  56.  Read bootblock from DF0:
  57.          Reads the bootblock from drive DF0: to the buffer.
  58.  
  59.  Write bootblock to DF0:
  60.          Writes the bootblock from the buffer to drive DF0:,
  61.           re-calculating the checksum so that it is correct.
  62.  
  63. File operations
  64.  
  65.  Load bootblock to buffer
  66.          Loads a file from disk to the buffer.
  67.  
  68.          The file must be one of the following :
  69.  
  70.                         ·Raw data (1024 bytes long)
  71.                         ·Executable with only 1 code hunk
  72.                                 (1052 bytes long)
  73.                         ·An executable with a BootUte header.
  74.                                 (1220 bytes long)
  75.  
  76.         The checksum can be invalid, because BootUte corrects it
  77.          automatically when the file is loaded.
  78.  
  79.  Save from buffer
  80.          Saves the buffer to a file, using the file type specified in
  81.           the preferences section.
  82.  
  83. Buffer Operations
  84.  
  85.  Execute
  86.          Executes the file in the buffer using the options specified
  87.           in the General Preferences section.
  88.  
  89.  Clear
  90.          Clears the bootblock from the buffer.
  91.  
  92.  Information
  93.          Displays the following information about the bootblock
  94.           that is in the buffer :
  95.                         ·Bootblock type (OFS, FFS etc.)
  96.                         ·Correct checksum.
  97.                         ·Whether the current checksum is valid.
  98.                         ·An ASCII dump of the bootblock.
  99.  
  100.  Quit BootUte
  101.          Exits BootUte.
  102.  
  103.  About BootUte
  104.          This displays information about the current version of
  105.           BootUte being used, and information about your Amiga
  106.           system.
  107.  
  108. Preferences
  109.  
  110. The preferences section is a set of six check boxes, split into two
  111.  sections, where options are either on or off.
  112.  
  113. General Preferences
  114.  
  115. Disable CPU Caches
  116.          This option disables the Instruction and Data caches found
  117.           on the 68020 processor and above.
  118.  
  119.          It is only selectable if a 68020 or above is present in the
  120.           system.
  121.  
  122. Trap MOVE SR,<ea>
  123.          This option traps the assembler command MOVE SR,<ea> because
  124.           it is a 'Supervisor Mode' instruction on the 68010 and
  125.           above, whereas on the 68000 it can be used in 'User Mode'
  126.           and 'Supervisor Mode'.
  127.  
  128.          It is only selectable if a 68010 or above is present in the
  129.           system.
  130.  
  131. No OS
  132.          This option disables multi-tasking and the systems
  133.           interrupts, making the program think that the operating
  134.           system isn't initialised.
  135.  
  136. No AGA
  137.          This option disables the AGA chipset, enabling more AGA
  138.           incompatable programs to run.
  139.  
  140. Save Preferences
  141.  
  142. NOTE : Only one of the below, or neither can be selected at the same
  143.         time, both cannot be selected at the same time.
  144.  
  145. Raw Binary
  146.          This option makes the 'Save bootblock from buffer' option
  147.           save the data as a binary file, so that it can't be run.
  148.  
  149. BootUte Header
  150.          This option makes the 'Save bootblock from buffer' option
  151.           save the data using a special header that enables demo's
  152.           to be run from the CLI.
  153.  
  154.  
  155.     This is a list of the possible error messages BootUte can give
  156.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  157. If BootUte quits straight away, without displaying any error
  158.  messages, it means that it couldn't allocate the memory that it
  159.  needs to function.
  160.  
  161. Alert number 0003 8004
  162.     BootUte was unable to open v36 or above of the intuition.library,
  163.      this should only ever appear if you are running less than
  164.      kickstart 2.0 (v36)
  165.  
  166. You must be running Kickstart 2.0 or above
  167.     BootUte was unable to open all of the libraries it needs as
  168.      v36 or better, this should only appear if you have a mixture
  169.      of pre 2.0 libraries and post 2.0 libraries in your libs:
  170.      drawer.
  171.  
  172. Unable to open reqtools.library
  173.     BootUte was unable to open the 'reqtools.library', it needs this
  174.      file in the libs: directory for all of it's requesters.
  175.  
  176. Unable to open screen.
  177.     BootUte was unable to open it's screen, this may be due to the
  178.      fact that the 'PAL' monitor file hasn't been run.
  179.  
  180. Unable to open window.
  181.     BootUte was unable to open the window that it uses.
  182.  
  183. Unable to open trackdisk.device.
  184.     BootUte was unable to open the 'trackdisk.device' that it needs
  185.      for the reading and writing of the bootblocks.
  186.  
  187. Unable to allocate ReqTools file requester.
  188.     BootUte was unable to allocate the structure necessary for the
  189.      'reqtools.library' file requester, this may be due to low
  190.      memory conditions.
  191.  
  192. Unable to read the bootblock
  193.     BootUte was unable to read the bootblock of the disk in DF0:
  194.     A possible cause is that there wasn't actually a disk in DF0:
  195.  
  196. Unable to write the buffer because it is empty.
  197.     BootUte was unable to write the bootblock buffer to DF0: because
  198.      the buffer was empty.
  199.  
  200. Unable to save the buffer because it is empty.
  201.     BootUte was unable to save the bootblock buffer to disk because
  202.      the buffer was empty.
  203.  
  204. Unable to execute the buffer because it is empty.
  205.     The buffer couldn't be executed because it was empty.
  206.  
  207. Unable to clear the buffer because it is empty.
  208.     The buffer couldn't be cleared because it was already clear.
  209.  
  210. Unable to write the bootblock.
  211.     BootUte couldn't write the bootblock to the disk in DF0:
  212.     A possible cause is that there isn't a disk in the drive.
  213.  
  214. There was an error reading the file.
  215.     BootUte couldn't read a bootblock to the buffer.
  216.     A possible cause is that the disk has got a read/write error.
  217.  
  218. There was an error writing the file
  219.     BootUte couldn't write the buffer to a file.
  220.     Possible causes are : the disk in the drive is write protected.
  221.                           the disk is full.
  222.                           the disk has got a read/write error.
  223.  
  224. Sorry, the file you are trying to
  225.  load isn't a valid bootblock
  226.     You are trying to load a file as a bootblock, and it isn't a
  227.      valid format.
  228.  
  229.  
  230.                               Disclaimer
  231.                   ¯¯¯¯¯¯¯¯¯¯
  232. This software is provided "as is" without warranty of any kind,
  233.  either expressed or implied. By using it, you agree to accept the
  234.  entire risk as to the quality and performance of the program. Should
  235.  the software prove defective, you assume the cost of all necessary
  236.  servicing, repair or correction.
  237.  
  238.  
  239.                              Distribution
  240.                  ¯¯¯¯¯¯¯¯¯¯¯¯
  241. BootUte is ©1994 TLS and may only be distributed by a PD library with
  242.  prior permission from me, to get this permission print out the file
  243.  called PD_Register.doc, fill it in and post it, along with a
  244.  small stamped self addressed envelope, to the address on the bottom
  245.  of the form.
  246.  
  247. The program can be distributed by any other means (BBS, mail etc.) as
  248.  long as the following conditions are met :
  249.  
  250.   1) No money changes hands.
  251.   2) The following files are included, in their original state and
  252.       are not modified in any way :
  253.  
  254.       BootUte          -  5844 bytes long.
  255.       BootUte.doc      - 11777 bytes long.
  256.       BootUte.guide    - 12636 bytes long.
  257.       PD_Register.doc  -  1820 bytes long.
  258.       Install.doc      -   404 bytes long. 
  259.       reqtools.library - Any version.
  260.  
  261.  
  262.                    A1200 Compatability Information
  263.            ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  264.         This information is only useful for users with A1200's
  265.         ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  266. A lot of compatability problems are due to the fact that the new
  267.  Amiga 1200's don't have any fast ram fitted as standard. If you own
  268.  an A1200, then I suggest that you buy a fast ram expansion as it
  269.  makes lots more programs run.
  270.  
  271.  
  272.                               Greetings
  273.                   ¯¯¯¯¯¯¯¯¯
  274. I would like to greet the following people :
  275.  
  276.  Oliver Norton (Edge) - Betatester (A4000/040)
  277.          Hope to see some AGA stuff now!!
  278.          You lucky g!t, do you think I might be able to do the same?
  279.  
  280.  Michael Morris - Betatester (A500+)
  281.          Come on, when are you going to get a new Amiga, it's about
  282.           time isn't it?
  283.  
  284.  
  285.                            Future Additions
  286.                ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  287. The following options will definately be added to future versions of
  288.  BootUte :
  289.  
  290.  »» 'Delay' option to allow for bootblocks/files that require mouse
  291.      buttons to be held down to access a 'hidden' part.
  292.  »» 'No Fast Ram' option to turn off fast ram, if it is fitted.
  293.  »» 'VBR to zero' option to reset the Vector Base Register to zero.
  294.  »» 'Localisation' - For workbench 3.0+ to enable users in other
  295.                       countries to have the menus etc in their own
  296.                       language.
  297.  »» Ability to use other screen modes apart from the built in
  298.      'PAL: Hires', using the ReqTools Screen mode requester.
  299.  »» Ability to use drives other than DF0:
  300.  »» Ability to load and execute executable files.
  301.  »» 'No Fast Ram' option for programs that don't like fast ram.
  302.  
  303. The following options may be added to future versions of BootUte,
  304.  providing I get enough feedback from you (the users).
  305.  
  306.  »» 'Fake Fast Ram' option for users unable to afford a fast ram
  307.      expansion.
  308.  »» 'Arexx interface'
  309.  
  310. If you think of any more options, or want the 'possible' options
  311.  added then write/or e-mail me (see further down this file for my
  312.  address.)
  313.  
  314.  
  315.                            Testing BootUte
  316.                ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  317. BootUte has been tested on the following platforms/configurations.
  318.  
  319. Amiga 1200
  320.         2 mb Chip, 4 mb Fast & 20Mhz 68881
  321.         80 mb Seagate 2.5" IDE Hard Drive
  322.         External Power XL High Density floppy drive.
  323.  
  324.         Kickstart 3.0 ROM (v39)
  325.  
  326. Amiga 4000/040
  327.         2 mb Chip, 2 mb Fast
  328.         120 mb Seagate 3.5" IDE Hard Drive
  329.  
  330.         Kickstart 3.0 ROM (v39)
  331.  
  332. Amiga 500+
  333.         1 mb Chip, 0 mb Fast
  334.  
  335.         Kickstart 2.04 ROM (v37)
  336.  
  337. BootUte has been tested fully with 'Enforcer', and has been found to
  338.  produce no enforcer hits.
  339.  
  340.  
  341.                             Contacting me
  342.                 ¯¯¯¯¯¯¯¯¯¯¯¯¯
  343. I can be contacted in the following ways:
  344.  
  345. E-Mail (Internet) : se1pt@dmu.ac.uk
  346.  
  347. Snail-Mail :
  348.                 Paul Toyne,
  349.                 1 Sherrard Drive,
  350.                 Sileby,
  351.                 Leicestershire
  352.                 LE12 7SG
  353.                 ENGLAND
  354.